<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>模式修饰符</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="regexp.reference.performance.html">« 性能</a></li>
      <li style="float: right;"><a href="reference.pcre.pattern.differences.html">与 perl 的不同之处 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="pcre.pattern.html">PCRE模式</a></li>
    <li>模式修饰符</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="reference.pcre.pattern.modifiers" class="article">
 <h1>模式修饰符</h1>

 
  <p class="para">
  下面列出了当前可用的 PCRE 修饰符。括号中提到的名字是 PCRE 内部这些修饰符的名称。
  模式修饰符中的空格，换行符会被忽略，其他字符会导致错误。
  </p>
  <p class="para">
   <blockquote class="blockquote">
    <dl>
     
      <dt>
<em class="emphasis">i</em> (<code class="literal">PCRE_CASELESS</code>)</dt>

      <dd>

       <span class="simpara">
       如果设置了这个修饰符，模式中的字母会进行大小写不敏感匹配。
       </span>
      </dd>

     
     
      <dt>
<em class="emphasis">m</em> (<code class="literal">PCRE_MULTILINE</code>)</dt>

      <dd>

       <span class="simpara">
       默认情况下，PCRE 认为目标字符串是由单行字符组成的(然而实际上它可能会包含多行)，
   &quot;行首&quot;元字符 (^) 仅匹配字符串的开始位置， 而&quot;行末&quot;元字符 ($) 仅匹配字符串末尾，
   或者最后的换行符(除非设置了 <em class="emphasis">D</em> 修饰符)。这个行为和 perl 相同。
       </span>
       <span class="simpara">
       当这个修饰符设置之后，“行首”和“行末”就会匹配目标字符串中任意换行符之前或之后，另外，
       还分别匹配目标字符串的最开始和最末尾位置。这等同于 perl 的 /m 修饰符。如果目标字符串
       中没有 &quot;\n&quot; 字符，或者模式中没有出现 ^ 或 $，设置这个修饰符不产生任何影响。
       </span>
      </dd>

     
     
      <dt>
<em class="emphasis">s</em> (<code class="literal">PCRE_DOTALL</code>)</dt>

      <dd>

       <span class="simpara">
       如果设置了这个修饰符，模式中的点号元字符匹配所有字符，包含换行符。如果没有这个
       修饰符，点号不匹配换行符。这个修饰符等同于 perl 中的/s修饰符。 一个取反字符类比如
       [^a] 总是匹配换行符，而不依赖于这个修饰符的设置。
       </span>
      </dd>

     
     
      <dt>
<em class="emphasis">x</em> (<code class="literal">PCRE_EXTENDED</code>)</dt>

      <dd>

       <span class="simpara">
       如果设置了这个修饰符，模式中的没有经过转义的或不在字符类中的空白数据字符总会被忽略， 
       并且位于一个未转义的字符类外部的#字符和下一个换行符之间的字符也被忽略。
        这个修饰符
       等同于 perl 中的 /x 修饰符，使被编译模式中可以包含注释。 注意：这仅用于数据字符。 空白字符
       还是不能在模式的特殊字符序列中出现，比如序列 (?( 引入了一个条件子组(译注: 这种语法定义的
       特殊字符序列中如果出现空白字符会导致编译错误。 比如(?(就会导致错误)。
       </span>
      </dd>

     
     
      <dt>
<em class="emphasis">A</em> (<code class="literal">PCRE_ANCHORED</code>)</dt>

      <dd>

       <span class="simpara">
       如果设置了这个修饰符，模式被强制为&quot;锚定&quot;模式，也就是说约束匹配使其仅从
       目标字符串的开始位置搜索。这个效果同样可以使用适当的模式构造出来，并且
       这也是 perl 种实现这种模式的唯一途径。
       </span>
      </dd>

     
     
      <dt>
<em class="emphasis">D</em> (<code class="literal">PCRE_DOLLAR_ENDONLY</code>)</dt>

      <dd>

       <span class="simpara">
       如果这个修饰符被设置，模式中的元字符美元符号仅仅匹配目标字符串的末尾。如果这个修饰符
       没有设置，当字符串以一个换行符结尾时， 美元符号还会匹配该换行符(但不会匹配之前的任何换行符)。
   如果设置了修饰符<em class="emphasis">m</em>，这个修饰符被忽略. 在 perl 中没有与此修饰符等同的修饰符。
       </span>
      </dd>

     
     
      <dt>
<em class="emphasis">S</em></dt>

      <dd>

       <span class="simpara">
       当一个模式需要多次使用的时候，为了得到匹配速度的提升，值得花费一些时间
       对其进行一些额外的分析。如果设置了这个修饰符，这个额外的分析就会执行。当前， 
       这种对一个模式的分析仅仅适用于非锚定模式的匹配(即没有单独的固定开始字符)。
       </span>
      </dd>

     
     
      <dt>
<em class="emphasis">U</em> (<code class="literal">PCRE_UNGREEDY</code>)</dt>

      <dd>

       <span class="simpara">
       这个修饰符逆转了量词的&quot;贪婪&quot;模式。 使量词默认为非贪婪的，通过量词后紧跟<code class="literal">?</code>
       的方式可以使其成为贪婪的。这和 perl 是不兼容的。 它同样可以使用
       <a href="regexp.reference.internal-options.html" class="link">模式内修饰符设置</a>
       (<code class="literal">?U</code>)进行设置， 或者在量词后以问号标记其非贪婪(比如<code class="literal">.*?</code>)。
       </span>
       <blockquote class="note"><p><strong class="note">注意</strong>: 
        <p class="para">
        在非贪婪模式，通常不能匹配超过
        <a href="pcre.configuration.html#ini.pcre.backtrack-limit" class="link">pcre.backtrack_limit</a>
        的字符。
        </p>
       </p></blockquote>
      </dd>

     
     
      <dt>
<em class="emphasis">X</em> (<code class="literal">PCRE_EXTRA</code>)</dt>

      <dd>

       <span class="simpara">
       这个修饰符打开了 PCRE 与 perl 不兼容的附件功能。模式中的任意反斜线后就 ingen 一个
       没有特殊含义的字符都会导致一个错误，以此保留这些字符以保证向后兼容性。
        默认情况下，在 perl 中，反斜线紧跟一个没有特殊含义的字符被认为是该字符的原文。
       当前没有其他特性由这个修饰符控制。
       </span>
      </dd>

     
     
      <dt>
<em class="emphasis">J</em> (<code class="literal">PCRE_INFO_JCHANGED</code>)</dt>

      <dd>

       <span class="simpara">
       内部选项设置(?J)修改本地的<code class="literal">PCRE_DUPNAMES</code>选项。允许子组重名，
       (译注：只能通过内部选项设置，外部的 /J 设置会产生错误。)
       自 PHP 7.2.0 起，也能支持 <code class="literal">J</code> 修饰符。
       </span>
      </dd>

     
     
      <dt>
<em class="emphasis">u</em> (<code class="literal">PCRE_UTF8</code>)</dt>

      <dd>

       <span class="simpara">
       此修正符打开一个与 Perl 不兼容的附加功能。 模式和目标字符串都被认为是 UTF-8 的。
        无效的目标字符串会导致 preg_* 函数什么都匹配不到；
        无效的模式字符串会导致 E_WARNING 级别的错误。
        5 字节和 6 字节的 UTF-8 字符序列以无效字符序列对待。
       </span>
      </dd>

     
    </dl>

   </blockquote>
  </p>
</div>
</div></div></body></html>